home *** CD-ROM | disk | FTP | other *** search
/ MacFormat España 4 / MacFormat n. 4 (Spain) / MacFormat 4.bin / Shareware en MacFormat / Mac Spectacle 1.1.6 / README / README Documentation < prev    next >
Encoding:
Text File  |  1995-03-05  |  7.4 KB  |  207 lines
  1. Mac Spectacle   -   Documentation   -   17.Feb.95 KIO !
  2. -------------------------------------------------------
  3.  
  4. Mac Spectacle is a software emulator of the Sinclair ZX Spectrum, 
  5. running on most Macintosh computers.
  6.  
  7.  
  8. Contents
  9. --------
  10.  
  11. ** System requirements
  12. ** Imortant note!
  13. ** Instructions
  14. ** Bug report
  15. ** Credits
  16.  
  17.  
  18. System requirements
  19. -------------------
  20.  
  21. Mac Spectacle runs on any Macintosh computer that meets the 
  22. following requirements:
  23.    mc68020 or higher; PPC is ok
  24.    System 7.0 or higher
  25.    color Quickdraw and Quicktime
  26.  
  27. In the actual version 8bit indexed color, 8 bit greyscale or 16bit true color 
  28. video is recommended. In 1, 2, 4 and 32bit mode the screen update and window refresh 
  29. is very slow. When the ZX Spectrum window is not the top window or when it is not
  30. entirely within the screen, screen update and refresh is slow in any screen mode.
  31. For some reason, Notebooks go to sleep mode, even if the emulator is running.
  32.  
  33.  
  34. IMPORTANT NOTE
  35. --------------
  36.  
  37. NEVER kill the emulator using control+option+escape except really nothing
  38. else works, for this will leave a ticker routine installed and you will 
  39. potentially not even manage to shut down your Macintosh properly.
  40.  
  41. The emulator is running very stable. It only crashed my Mac when i was 
  42. testing new routines.
  43.  
  44.  
  45. Instructions
  46. ------------
  47.  
  48. The menus:
  49.  
  50. Apple
  51.     About ...        Shows some legal notes and a photo of me
  52.     Keyboard        Toggles the display of a ZX Spectrum keyboard on/off
  53.  
  54. File
  55.     Load core        loads a .SNA or .Z80 snapshot file
  56.     Save core        saves a .SNA or .Z80 snapshot file
  57.     Restart        reloads ROM and does a reset
  58.     Hold        suspends the Z80 CPU
  59.     Resume        resumes the Z80 CPU
  60.     Insert tape        open a tape file for subsequent LOAD ""
  61.     Eject tape        closes an open tape file
  62.     Save picture    saves a pict file (not a bitmap!)
  63.     Save preferences    Saves some settings and window locations as preferences
  64.     Quit        quits application
  65.  
  66. Display
  67.     1:1            tiny screen
  68.     2:1            double size screen, only a little bit slower
  69.     Refresh 1/25    screen update 25 times a second (slows down emulation)
  70.     ...
  71.     Refresh 6/25    screen update only 25/6 times a second (fastest emulation)
  72.  
  73. Options
  74.     Basic keyboard    Remapping of most keys, roll over supression
  75.     Game keyboard    Native Specci keyboard, physical layout
  76.     International    Menus, messages etc. in English
  77.     German        Menus, messages etc. in German
  78.  
  79. Debugger
  80.   ( Trace mode )    Extended debugging version only    
  81.     Logfile        Submenu: verbosity of logfile messages
  82.     Console        Submenu: verbosity of console messages
  83.   ( Trigger NMI )    Trigger non maskable interrupt
  84.   ( Trigger interrupt )    For debugging purpose only
  85.   ( Trigger Reset )    Better use Restart from File menu
  86.   ( Clear profiles )    Extended debugging version only    
  87.   ( List ... )        Extended debugging version only    
  88.   ( Map ... )        Extended debugging version only    
  89.   ( Show 1st ... )    Extended debugging version only    
  90.   ( ***test*** )    For debugging purpose only    
  91.  
  92. Windows
  93.     Console        Window for all messages, errors, notes etc.
  94.     ZX Spectrum        The window you are mostly interested in
  95.     Tape recorder    Window with some controls to handle tape files
  96.     Keyboard        Highres display of a ZX Spectrum keyboard
  97.   
  98.  
  99. Loading and saving snapshots:
  100.  
  101. .SNA and .Z80 files may be launched by drag&drop, or if they were created
  102. by Mac Spectacle by double clicking, or from the File menu. Snapshots 
  103. only contain information about the ZX Spectrum side, not about any 
  104. settings of the emulator. So window size, location or keyboard setting 
  105. aren't affected. If the snap doesn't launch, the Z80 CPU may be halted, 
  106. try 'Resume' or 'Restart' from the File menu. Snapshots may be saved at 
  107. any time from the File menu. If the file name ends on ".z80" or ".sna"
  108. then the appropriate format is choosen for saving. Otherwise the save
  109. routine defaults to the old file format (if a file is overwritten)
  110. or to .Z80 file format (if a new file is created).
  111.  
  112. Loading tapes:
  113.  
  114. .tape files represent the original program tapes. They may be opened by 
  115. drag&drop or by double click or from the file menu. A small window
  116. opens, showing some tape recorder controls. The window is not topped,
  117. to leave the ZX Spectrum window in front. You normally don't need to
  118. access it. If you type LOAD "" (you know, you have to type j"" if you
  119. have selected basic keyboard mapping or even <j> <option+p> <option+p> 
  120. if you have selected the game keyboard) the emulator reads from this 
  121. file. If you type LOAD"" without a tape open, you will be prompted. If
  122. you open the tape recorder window from the windows menu, you will be
  123. prompted too.
  124.  
  125.  
  126. Bug report
  127. ----------
  128.  
  129. Not yet supported:
  130.  
  131.    Sound
  132.    Writing to any location on a tape; erasing tapes
  133.    Writing .scr file format for screenshots
  134.    versions higher than ZX Spectrum 48k
  135.    Joystick (i think of Kempston)
  136.    Trace mode
  137.    PPC native code
  138.    Fast 1, 2, 4 and 32bit screen refresh
  139.    Faster refresh for windows "not in optimal position"
  140.  
  141. Not implemented:
  142.  
  143.    INI, IND, INIR, INDR
  144.    OUTI, OUTD, OTIR, OTDR
  145.    IM0 with multi-byte instructions
  146.    exact timing of Z80 instructions
  147.    exact incrementation of R
  148.    exact implementation of DAA
  149.    Some undocumented behaviour of the Z80 CPU
  150.  
  151. Errors/known problems:
  152.  
  153.    There ARE errors in the Z80 emulation. At least ONE.
  154.    ATIC ATAC sometimes doesn't realize the player wants to leave a room
  155.    FRED freezes when you find a map.
  156.    The Basic interpreter writes garbage to some of the first characters,
  157.    when you edit Basic lines or scroll through a Basic program.
  158.    But most games run good (including ATIC ATAC)
  159.    I appreciate anybody making suggestions on the wrong emulated opcodes!
  160.    
  161.    DAA handling is lossy, that means, it may fail. I do not support the 
  162.    corresponding flags, i do it my way.
  163.    
  164.    I do a good job keeping all pointers inside the Z80 core. But there
  165.    are some conditions that are not checked:
  166.    * SP may be incremented or decremented beyond RAM and ROM.
  167.    * overwriting the ROM
  168.    
  169.    If the ZX Spectrum window is not the frontmost and not fully inside
  170.    the screen, i delegate the task to redraw the window to QuickDraw. 
  171.    Then screen update and window refresh is slow.
  172.    
  173.    Secondary screens are not handled correctly. Test it, you'll see it.
  174.       
  175.    I've not yet found the right way to swich off the mouse arrow.
  176.    
  177.    Sound output slows down the emulation. If you think Mac Spectacle
  178.    hangs at the beginning of games or new levels, it is most probably
  179.    playing some sound.
  180.      
  181.   
  182. Credits
  183. -------
  184.  
  185. Mac Spectacle contains the original ZX Spectrum 1982 ROM in it's resource
  186. fork. The ROM is copyrighted and the owner of the copyright is AMSTRAD,
  187. who has taken over Sinclair Inc.. Fortunately AMSTARD has stated publically,
  188. that the unmodified ZX Spectrum ROM may be distributed with any software 
  189. emulator of the ZX Spectrum. I think, we have to thank them for this.
  190.  
  191. In addition, i have included two program tapes for demonstration purpose,
  192. "pool" is a billard simulation and "Lords of Midnight" a fantasy role
  193. playing game, based on some Tolkien stuff. Both are still copyrighted,
  194. but permission to copy is granted by their respective copyright holders.
  195. I have checked this mainly by looking them up at ftp.nvg.unit.no.
  196. Credits go to Mike Singleton and Mike Lamb.
  197.  
  198. The picture of the ZX Spectrum keyboard layout was designed and is
  199. copyrighted by Bo Lindbergh. Thanks for his permission to use it in
  200. Mac Spectacle.
  201.  
  202. Special thanks to Gerton Lunter, who has collected a great amount of 
  203. Z80 and ZX Spectrum specialities which only Z80 emulator programmers 
  204. must know about.
  205.  
  206.     ... KIO !
  207.